<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Run Beats 帮助文档</title>
    <style>
        body {
            font-family: "Microsoft YaHei", Arial, sans-serif;
            line-height: 1.6;
            max-width: 800px;
            margin: 0 auto;
            padding: 20px;
            background-color: #f5f5f5;
        }
        .container {
            background-color: white;
            padding: 30px;
            border-radius: 10px;
            box-shadow: 0 0 10px rgba(0,0,0,0.1);
        }
        h1, h2, h3 {
            color: #333;
        }
        h1 {
            text-align: center;
            border-bottom: 2px solid #4CAF50;
            padding-bottom: 10px;
        }
        h2 {
            border-left: 4px solid #4CAF50;
            padding-left: 10px;
            margin-top: 30px;
        }
        ul, ol {
            padding-left: 20px;
        }
        li {
            margin-bottom: 10px;
        }
        .feature {
            background-color: #e8f5e9;
            padding: 15px;
            border-radius: 5px;
            margin: 15px 0;
        }
        .step {
            background-color: #fff3e0;
            padding: 15px;
            border-radius: 5px;
            margin: 15px 0;
        }
        .tip {
            background-color: #e3f2fd;
            padding: 15px;
            border-radius: 5px;
            margin: 15px 0;
            border-left: 4px solid #2196F3;
        }
        .navigation {
            background-color: #e0f7fa;
            padding: 15px;
            border-radius: 5px;
            margin: 15px 0;
            border-left: 4px solid #0097a7;
        }
        .nav-link {
            display: block;
            margin: 5px 0;
            color: #006064;
            text-decoration: none;
        }
        .nav-link:hover {
            text-decoration: underline;
        }
        .bug-report {
            background-color: #ffebee;
            padding: 15px;
            border-radius: 5px;
            margin: 15px 0;
            border-left: 4px solid #f44336;
            text-align: center;
        }
        .bug-link {
            color: #4a6fa5;
            text-decoration: underline;
        }
        code {
            background-color: #f0f0f0;
            padding: 2px 5px;
            border-radius: 3px;
            font-family: Consolas, monospace;
        }
    </style>
</head>
<body>
    <div class="container">
        <h1>Run Beats 帮助文档</h1>
        
        <div class="bug-report">
            <p><strong>BUG反馈：</strong>如果您发现软件BUG，可以<a href="https://www.bilibili.com/video/BV1sxndzvEwa/?share_source=copy_web&vd_source=3b3e1ae9fa3fe12b20e8ba6eb1640b56" target="_blank" class="bug-link">点击这里评论反馈BUG</a></p>
        </div>
        
        <p>Run Beats 是一款专为跑步爱好者设计的音乐处理软件。它能够识别每首歌的 BPM（每分钟节拍数），并根据您跑步的步频调整音乐速度，添加鼓点节奏，让您的跑步步频更加稳定和轻松。</p>
        
        <div class="navigation">
            <h3>文档导航</h3>
            <a href="#core-features" class="nav-link">核心功能</a>
            <a href="#usage-guide" class="nav-link">使用指南</a>
            <a href="#advanced-tutorial" class="nav-link">进阶教程：鼓点功能详解</a>
            <a href="#important-notes" class="nav-link">注意事项</a>
            <a href="#faq" class="nav-link">常见问题</a>
            <a href="#support" class="nav-link">技术支持</a>
        </div>
        
        <div class="feature">
            <h2 id="core-features">核心功能</h2>
            <p>Run Beats 支持三种音乐处理方式：</p>
            <ol>
                <li><strong>单曲处理</strong> - 对单首歌曲进行 BPM 调整和鼓点添加</li>
                <li><strong>串烧制作</strong> - 将多首处理后的歌曲合并成一个连续的音乐串烧</li>
                <li><strong>视频生成</strong> - 基于音乐串烧生成带背景的视频文件</li>
            </ol>
        </div>
        
        <h2 id="usage-guide">使用指南</h2>
        
        <h3>1. 准备工作</h3>
        <div class="step">
            <p><strong>步骤：</strong></p>
            <ol>
                <li>点击"打开音频目录"按钮选择包含音乐文件的文件夹</li>
                <li>软件会自动分析目录中的音乐文件并识别其原始 BPM</li>
                <li>在文件列表中勾选您想要处理的音乐文件</li>
            </ol>
        </div>
        
        <h3>2. 音乐预览功能</h3>
        <div class="step">
            <p><strong>您可以预览音乐文件以方便筛选歌曲：</strong></p>
            <ul>
                <li>在文件列表中，每个歌曲条目旁边都有一个播放按钮，点击即可预览该歌曲</li>
                <li>再次点击播放按钮或点击其他歌曲的播放按钮可切换播放</li>
                <li>点击"播放/暂停"按钮可控制音乐播放状态</li>
                <li>您也可以在右侧"已选择列表"中点击歌曲名称来播放</li>
                <li>播放时可通过进度条拖拽来跳转到指定位置</li>
                <li>播放时点击"鼓点开关"按钮可试听带有鼓点的音乐效果</li>
            </ul>
        </div>
        
        <h3>3. 设置目标 BPM</h3>
        <div class="step">
            <p><strong>步骤：</strong></p>
            <ol>
                <li>使用 BPM 滑块设置您的目标跑步步频（建议值：160-180 BPM）</li>
                <li>软件会根据目标 BPM 自动计算每首歌曲的变速倍数</li>
            </ol>
        </div>
        
        <h3>4. 生成跑步单曲</h3>
        <div class="step">
            <p><strong>步骤：</strong></p>
            <ol>
                <li>在文件列表中选择要处理的歌曲</li>
                <li>点击"生成跑步单曲"按钮</li>
                <li>软件会自动调整歌曲速度并添加鼓点节奏</li>
                <li>处理完成的文件保存在 <code>out_audio/run_single</code> 目录中</li>
            </ol>
        </div>
        
        <h3>5. 生成跑步串烧</h3>
        <div class="step">
            <p><strong>步骤：</strong></p>
            <ol>
                <li>在文件列表中选择多首歌曲</li>
                <li>设置串烧总时长（默认为90分钟）</li>
                <li>点击"生成跑步串烧"按钮</li>
                <li>软件会将选中的歌曲随机排序并合并成一个连续的串烧</li>
                <li>处理完成的文件保存在 <code>out_audio/run_mix</code> 目录中</li>
            </ol>
        </div>
        
        <h3>6. 生成串烧视频</h3>
        <div class="step">
            <p><strong>步骤：</strong></p>
            <ol>
                <li>确保已生成跑步串烧文件</li>
                <li>点击"生成串烧视频"按钮</li>
                <li>软件会基于音乐串烧生成带播放列表的视频文件</li>
                <li>处理完成的文件保存在 <code>out_audio/run_video</code> 目录中</li>
            </ol>
        </div>
        
        <h2 id="advanced-tutorial">进阶教程：鼓点功能详解</h2>
        <div class="tip">
            <p><strong>鼓点功能让您精确调整音乐节拍，确保与您的跑步节奏完美同步：</strong></p>
            
            <div class="navigation">
                <h3>鼓点功能导航</h3>
                <a href="#drum-operations" class="nav-link">鼓点操作功能</a>
                <a href="#tap-beat-methods" class="nav-link">手敲鼓点使用方法</a>
                <a href="#update-vs-save" class="nav-link">更新鼓点与保存鼓点的区别</a>
                <a href="#best-practices" class="nav-link">最佳实践建议</a>
            </div>
            
            <h3 id="drum-operations">鼓点操作功能</h3>
            <ul>
                <li><strong>更新鼓点</strong> - 临时试听调整后的鼓点效果，切换歌曲后会复位</li>
                <li><strong>还原鼓点</strong> - 恢复到系统自动识别的原始鼓点设置</li>
                <li><strong>保存鼓点</strong> - 持久化保存当前鼓点设置，供后续生成使用</li>
                <li><strong>手敲鼓点</strong> - 通过手动敲击精确调整BPM和偏移量</li>
                <li><strong>鼓点开关</strong> - 播放时点击可切换鼓点状态，试听带有鼓点的音乐效果</li>
            </ul>
            
            <h3 id="tap-beat-methods">手敲鼓点使用方法</h3>
            <ol>
                <li><strong>单次敲击</strong> - 播放音乐时点击"手敲鼓点"按钮一次，BPM保持不变，只调整偏移量</li>
                <li><strong>多次敲击</strong> - 跟随音乐节奏多次点击"手敲鼓点"按钮，系统会根据敲击间隔重新计算BPM和偏移量</li>
                <li><strong>确认效果</strong> - 当输入框中的BPM数值稳定不再变化时，即可点击"更新鼓点"试听效果</li>
                <li><strong>试听效果</strong> - 点击"鼓点开关"按钮可在播放时试听带有鼓点的音乐效果</li>
            </ol>
            
            <h3 id="update-vs-save">更新鼓点与保存鼓点的区别</h3>
            <ul>
                <li><strong>更新鼓点</strong> - 仅用于临时试听，切换到其他歌曲后再切换回来时会恢复原状</li>
                <li><strong>保存鼓点</strong> - 将当前鼓点设置永久保存，后续生成音乐时会使用保存的设置</li>
            </ul>
            
            <div class="step" id="best-practices">
                <p><strong>最佳实践建议：</strong></p>
                <ul>
                    <li>使用耳机可以更清晰地听到鼓点，便于精确调整</li>
                    <li>多次敲击时保持稳定的节奏，以获得更准确的BPM计算结果</li>
                    <li>调整满意后记得点击"保存鼓点"，否则切换歌曲后需要重新调整</li>
                    <li>播放时点击"鼓点开关"按钮可实时试听鼓点效果</li>
                </ul>
            </div>
        </div>
        
        <h2 id="important-notes">注意事项</h2>
        <div class="tip">
            <p><strong>重要提示：</strong></p>
            <ul>
                <li>建议使用节奏感强且节奏均匀的音乐制作跑步音乐</li>
                <li>目标 BPM 应根据个人跑步习惯设置，一般在 160-190 BPM 之间</li>
                <li>处理时间取决于文件大小和计算机性能，请耐心等待</li>
                <li>生成的文件会自动添加目标 BPM 信息到文件名中以便识别</li>
                <li>串烧功能会随机排序选中的歌曲，确保跑步过程中的音乐多样性</li>
                <li>串烧最终时长受到输入的时长限制</li>
                <li><strong>本软件只支持匀速的音乐，不支持变速的音乐或多首歌连起来的音频</strong></li>
            </ul>
        </div>
        
        <h2 id="faq">常见问题</h2>
        <div class="tip">
            <p><strong>Q: 如何提高处理速度？</strong></p>
            <p>A: 捐赠用户可以享受多线程并行处理，显著提高处理速度。</p>
            
            <p><strong>Q: 支持哪些音频格式？</strong></p>
            <p>A: 支持常见的音频格式，如 MP3、WAV、FLAC 等。</p>
            
            <p><strong>Q: 如何更新软件？</strong></p>
            <p>A: 通过菜单栏"更新"选项可以检查并下载最新版本。</p>
        </div>
        
        <h2 id="support">技术支持</h2>
        <p>如有其他问题，请访问我们的官方网站获取更多信息。</p>
        <p>邮箱：421731394@qq.com</p>
    </div>
</body>
</html>